<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>MPI</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<A NAME="MPI"><H1>MPI</H1></A>
Introduction to the Message-Passing Interface 
<H2>Description</H2>
<P>
MPI stands for Message Passing Interface.
MPI is a specification (like C or Fortran) and there are a number of
implementations.  The rest of this man page describes the use of the MPICH
implementation of MPI.
<P>
<H2>Getting started</H2>
<P>
Add MPI to your path
<PRE>
        % set path = ( $path /usr/local/mpi/bin )
</PRE>

for the <TT>csh</TT> and <TT>tcsh</TT> shells, or
<PRE>
        % export path=$path:/usr/local/mpi/bin
</PRE>

for <TT>sh</TT>, <TT>ksh</TT>, and <TT>bash</TT> shells.
<P>
Compute pi to a given resolution on 8 processes
<PRE>
        % mpiexec -n 8 /usr/local/mpi/examples/cpi
</PRE>

<P>
You can compile and link your own MPI programs with the commands <TT>mpicc</TT>,
<TT>mpif77</TT>, <TT>mpicxx</TT>, and <TT>mpif90</TT>:
<PRE>
        % mpicc -o cpi cpi.c
        % mpif77 -o fpi fpi.f
        % mpicxx -o cxxpi cxxpi.cxx
        % mpif790 -o pi3f90 pi3f90.f90
</PRE>

using the source code from <EM>/usr/local/mpi/examples</EM>.
<P>
<H2>Documentation</H2>
<P>
PDF documentation can be found in directory
<TT>/usr/local/mpi/doc/</TT>.  These include an installation manual (<TT>install.pdf</TT>)
and a user's manual (<TT>usermanual.pdf</TT>).
<P>
Man pages exist for every MPI subroutine and function.  The man pages are
also available on the Web at <TT>http://www.mcs.anl.gov/mpi/www</TT>.
Additional on-line information is available at <TT>http://www.mcs.anl.gov/mpi</TT>,
including a hypertext version of the standard, information on other libraries
that use MPI, and pointers to other MPI resources.
<P>
<H2>Version</H2>
<P>
MPICH2 version 1.0
<P>
<H2>License</H2>
<P>
Copyright 2002 University of Chicago.
See the file <TT>COPYRIGHT</TT> for details.  The source code is freely available
by anonymous ftp from <TT>ftp.mcs.anl.gov</TT> in <TT>pub/mpi/mpich2-beta.tar.gz</TT> .
<P>
<H2>Files</H2>
<P>
<PRE>
/usr/local/mpi/                 MPI software directory
/usr/local/mpi/COPYRIGHT        Copyright notice
/usr/local/mpi/README           various notes and instructions
/usr/local/mpi/bin/             binaries, including mpiexec and mpicc
/usr/local/mpi/examples         elementary MPI programs
/usr/local/mpi/doc/             documentation
/usr/local/mpi/include/         include files
/usr/local/mpi/lib/             library files
</PRE>

<P>
<H2>Contact</H2>
<P>
MPI-specific suggestions and bug reports should
be sent to <TT>mpich-discuss@mcs.anl.gov</TT>.
<P>
<P><B>Location:</B>manpage.txt<P>
</BODY></HTML>
